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CONGRATULATIONS on the purchase of your PT-68K2/K4. I have been 
selling and using Peripheral Technology products for the past 10 years and my 
customers and I are very happy with their products, service and support. Since 1978 I 
have been developing business oriented programs for the Motorola 6800 & 6809 and I 
am now converting them to the 68000. The following products are available from Palm 
Beach Software. 

EDDI a screen editor and formatter. $50.00 

EDDI has 62 key commands to completely manage the text and screen display, 
and 22 formatting commands to control the printed output. It is also convenient for 
use as a program editor supporting line numbers, tab stops and macro keys. A spelling 
helper, synonym finder and other DOS utilities are available without exiting EDDI. 
Two banks of memory are supported so that you can edit two files and move data back 
and forth. DOCUMAKER (a boiler plate document creator) and MERGER (personalized 
name, text and address insertion) will be available in late 1992. 

SPELLB a 160,000 word spelling checker. $50.00 

SPELLB has been around in the 6809 version for 11 years. It is still on version 
1.0 and I have only fixed two misspellings. 

ASMK a native code assembler. $25.00 

ASMK is a bare bones, native code, 68000 assembler. It does not have macros or 
conditional assembly and you must have enough memory to hold the complete source and 
object code. The syntax is similar to other 6800 and 6809 assemblers which were 
common to the SS-50 world. It is very fast. 

SUBCAT a sub-directory manager. $25.00 

SUBCAT is a program that will allow multiple directories; setup in a tree 
structure on a disk. The disk directory is not altered and is still the primary source of 
information about each file. Each entry has a 36 byte message area where you can keep 
a description of the file and its contents. A long block of reverse video is moved to 
select an entry and now you can execute the following operations on the selected file. 
Assemble, copy, delete, edit, get or execute, help, kill, install, load, enter message, 
rename and view. Other operations; backup, execute DOS command, scan, update, zap 
and exit can be done from any position. Two other commands are user definable. In 
essence you can create a tree like catalog structure and then manipulate the files in 
these catalogs as an independent directory. 

KR ACKER a disassembler program. $25.00 

KR ACKER will allow you to scan through a program to create a memory map of 
code, text, tables, etc. When the memory map is competed you can create a source 
code file to disk, printer, or terminal. 

NAMES a Name and Address manager. $25.00 

NAMES allows you to make a Data base of names, addresses, phone numbers, 
and remarks. You can now print labels, telephone directors and address list, sorted on 
ID#, Name, Address, Zip code, Telephone # and Remarks 

MOZART a music editor (requires special card) $25.00 
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INTRODUCTION 

REX is a single user disk operating system for the 680XX 
microcomputer. The syntax and overall look and feel is based on a 
disk operating system from Digital Equipment's PDP-11 series. Any 
resemblance to other operating systems is purely coincidental. 

There are 3 divisions to REX, the Disk Operating System, the 
File Management System and the Utility Command Group. Each of these 
will be explained in its own section. 

REX version 4 is for the PT-68-K2/K4 and version 5 is for the CD- 
020. The only differences between the two is the addresses of the 
printer drivers and the floppy disk drivers. The convention of REXK? 
will be used throuhout this manual and ypu should use the version 
supplied on the system disk. Instructions for REXK4 which are 
different than for REXK5 will be in parentheses ( ). 

Getting STARTED 

The System disk which is supplied for the CD-020 is a HD disk 
prepared for either a 3.5" 1.4 meg drive or a 5.25" 1.2 meg drive. 
If you don't have that type of floppy drive you must make a special 
request for the proper disk. The drive must be addressed as Drive #0 
and connected to the 37C65 disk controller. The System disk which is 
supplied with the PT-68-K2/K4 is a 720K disk in either 3.5" or 5.25" 
size. The drive must be addressed as Drive #0 and connected to the 
1772 disc controller. Drive #0 is the end connection on the IBM type 
34 pin cable, after the twist. The jumper on the drive must be in 
the second drive position. 

When you turn the computer on you should have "MONK:" displayed 
on the screen, if you don't check the Monk manual. Insert the system 
disk in drive #0, be sure the write protect tab is in place, and 
press the"V" key to load REX. Unless your clock has been set you 
will be asked to enter todays date as Month, Day, Year; do so and you 
should have "REX:" displayed on the screen. 

At this point a number of the Utility routines will work. You 
should try CAT, this will list all the programs on the system disk. 
Other routines that you might like to try are SETIME, DATE, YEAR, and 
ASN. The next task is to make a backup copy of your system disk; 
however, we must have two drives in order to make the COPY utility 
work. The easiest way to do this is to create a RAM disk. 

Check to see if the memory end pointer is set to $6FFFF($FFFF) , 
type MEMEND and the current default value will be displayed. Type 
MEMEND , 6FFFF(FFFF) to set it, then type MEMEND again to see if it 
changed. Next CAT, 7 to see if the RAM disk has been installed, if 
not then type TURBO , 7 to install it. Copy the System disk to the RAM 
disk with COPY 0,7. When this is finished you must now create a 
formatted disk. Put a brand new disk in drive #0 and type 
7. FORMAT, 0. Give the disk a name of SYSTEM and and number of 11, 
answer the question with a "Y". After the disk is formatted type 
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7. COPY 7,0. When the copy is complete type LINK .REXK7F3 . COM for a 
3.5" diskette or LINK 0. REXK7F5.COM for a 5.25 M diskette. You should 
now have a working System Disk. It would be a good idea to make 
several more copies. The Utility routines which you have just used 
are explained in the Utility Command Section. 

The Syntax of a REX command is: 
[Drive #< . > ]<Filename> [< . >Extension ] [ < , >Parameters ] 
For example; . RENAME . COM , 1 . FILE1 . TXT , 1 . FILE2 . TXT 
This is the equivalent; RENAME ,FILE1 ,FILE2 

The items enclosed in [ ] are optional while items enclosed in < > 
are essential. In the above example, if the Drive # is used the <•> 
must follow the number. If the drive # is not included then REX will 
use the System Drive # (usually drive #0). The Filename is necessary 
but the Extension is not, if an Extension is used, it must be 
preceded by the period. If an extension is not used then an 
extension of .COM is assumed for the first filename in a command. 
The first parameter filename of 1.FILE1.TXT can be shortened to 
FILE1. REX will use the working drive # if a drive # is not 
specified and the RENAME utility will default to a .TXT extension if 
it is missing. The second parameter works about the same. The Space 
is the same as the comma (,) in the file specification so you can use 
which ever is more convenient, e.g RENAME FILE1 FILE2. 

The [Drive #< . > ]<Filename> [ < . >Extension ] is called a File 
specification or filespec for short. Several filespecs will make a 
Command. Normally there is one Command on a Command Line, but 2 or 
more could be there if they are separated by the colon (:). See the 
EXEC utility for an example. 

There are two memory resident commands in REX. The first is MON 

which will return control to MONK, the ROM resident monitor. The 

second is GET which will load a binary type file but will not run it. 
The Syntax for GET is: GET , <f ilespec> . 

At this time you need to tell REX what types of Floppy or Hard 
drives you have connected to the Computer. This is done thru the 
Utility DRIVESET (please go read the instructions for DRIVESET 3 
times.) REX can access up to 10 (0 to 9) Logical Drives. The 
information that describes these drives is kept in the Drive Info 
Table (DIT) at $3B00. The amount of memory that you have in your 
system is a factor in setting the RAM disks as well as the Track 
buffers. I suggest that you read through the rest of this manual 
before you make your decisions. 

After REX has booted up and displays or get the date it looks 
for a file called UPSTART .TXT. If it finds this file it will then 
execute the contents as though the input was from a keyboard. . 
Assuming that you have got a DRIVE(X), a PRINT(XX) and a TURBO, X that 
you need to install each time you boot REX you need to put these in 
the UPSTART.TXT file. Now every time you boot REX these programs 
will be run and REX will be ready to go . A sample UPSTART.TXT would 
look like this: 
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PRINTAB:DRIVEA:TURBO,7:WORK,l 

The UPSTART provided on your disk is: 

LOGO : SSBANER for REXK5 

MEMEND , FFFF : MEMEND : TURBO , 7 for REXK4 

Since REX comes up with system and work drives set to drive #0, 
the Printer driver would load from drive #0. DRIVEA would also load 
from that drive. TURBO, 7 and W0RK,1 would load .from what ever Drive. 
#0 that you specified in DRIVEA. If you have a hard disk you might 
want to specify HIDE(HARD) as the first entry in UPSTART and then 
DRIVEH. If HO is now LO, the rest of the entries would load from the 
Hard drive a much faster process. 

If you want to boot from the Hard drive you must prepare a 
version of REXDOS that loads the HIDE(HARD) along with REX. e.g 
APPEND, REXK7I.COM, HIDE. COM, REXDOS. SYS. Copy REXDOS to the Hard disk 
and link it. Make sure that the DRIVEH is on the hard disk and any 
other routines that you will put in UPSTART. Create an UPSTART .TXT 
with EDD, put it on the Hard disk, go to MONK (MON) and enter "W" . 
Now that's a fast boot. 

REX supports two printers #1 and #2. These can be either 
parallel at PORTA, PORTB, or Serial at C0M1, COM2, COM3, COMA. Once 
the printer drivers are set to your hardware selection and the 
printer connected, you direct output to the printer by putting a f, P" 
before the command, e.g. P,CAT would output the catalog of the 
working drive to printer #1. There are a number of "P" commands PS 
will print small (16 cpi) on #1 while PS2 will print small on #2. 
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THE DISK OPERATING SYSTEM 

The DOS has a number of user accessible variables and subroutines. 
The addresses of these routines are in a file called REXEQU.TXT, 
which is supplied. 



GLOBAL VARIABLES 



$2300 BSPCHR Backspace character 

$2301 DELCHR Delete character 

$2302 EOLCHR End of line character 

$2303 DEPTH Screen display line count 

$2304 WIDTH Screen display max column count 

$2305 NULLS Pad count for teletype terminal 

$2306 TABCHR Tab character 

$2307 BSECHR Backspace echo character 

$2308 EJECT Page eject count 

$2309 PAUSE Pause control count 

$230A ESCCHR Escape character 

$230B SDRN System drive number 

$230C WDRN Working drive number 

$230D SYSFLG Use system drive flag 

$230E SYSMON System month 

$230F SYSDAY System day 

$2310 SYSYER System year 

$2311 LSTTRM Last line terminator character 

$2312 USRCMD User command table pointer 

$2316 LBPTR Line buffer pointer 

$231A ESCRET Escape return pointer 

$231E CURCHR Current character 

$231F PREVCH Previous character 

$2320 CURLCT Current line number 

$2321 XFRFLG Transfer flag 

$2322 TFRADR Transfer address 

$2326 OFFLAD Loader offset address 

$232A ERRTYP Error type 

$232B IOFLAG Special I/O flag 

$232C OUTSWT Output switch 

$232D INSWT Input switch 

$2336 DOCMDF Command flag 

$2337 CURCOL Current output column 

$2338 MEMEND Memory end pointer 

$233C LODADR Binary load address 
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USER CALLABLE DISK OPERATING SYSTEM ROUTINES 
$2400 COLDS Cold start address. 
$2404 WARMS Warm start address. 
$2408 RENTER Re-enter main loop. 
$240C INCH Input character, (user changeable) 
$2410 INCH2 Input character. 

$2414 OUTCH Output character, (user changeable) 

$2418 0UTCH2 Output character. 

$241C GETCHR Get character. 

$2420 PUTCHR Put character. 

$2424 INBUFF Input into buffer. 

Input from the keyboard to the LINBUF. The delete 
character, backspace character, CR and LF are 
recognized, all other control codes are ignored. The 
cancel (CTL X) will prompt (???) and reenter INBUFF. The 
backspace will go back to the beginning of the buffer 
but not before it. The LF will echo the CR/LF to the 
terminal but only place a space in the buffer. The CR 
will terminate input and will be placed in the buffer. A 
maximum of 128 entries are allowed. On exit the LBPTR is 
pointing to the first character in the Line buffer. 

$2428 PSTRNG Print string. 

Al points to the first character of string. A CR/LF is 
output, and then the string is output until a $04 is 
encountered. On exit the Al register is pointing to the 
next character after the $04, all other registers except 
DO are preserved. 

$242C CLASS Classify character. 

The character in DO is tested and if it is an alpha or 
numeric character the carry is cleared on return. Any 
other character and the carry is set. All registers are 
preserved . 

$2430 PCRLF Output CR/LF. 

$2434 NXTCH Get next character. 

The character in CURCHR is moved to PREVCH and the 
character pointed by LBPTR is put in CURCHR and DO. More 
than one space is ignored and the LBPTR is advanced to 
point to the next character unless the last character 
was a CR or E0L. Exit is through CLASS and carry will 
be clear if character is alpha-numeric. All registers 
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are preserved except DO. 

$2438 RSTRIO Restore I/O vectors. 

This routine will set a number of I/O vectors and 
pointers to their original values. OUTCH is reset to 
0UTCH2, INCH is reset to INCH2, PAUSE is set on, INSWT, 
OUTSWT, and IOFLAG are all set to zero. 

$243C GETFIL Get file specification. 

AO must point to the FCB and LBPTR must point to a file 
specification. The file spec is parsed and the drive #, 
filename and extension if any, are put in their proper 
places in the FCB. On exit the carry will be clear if no 
errors were discovered and LBPTR will be pointing to the 
first character beyond the separator unless the 
separator was a CR or EOL. All registers except DO & D7 
are preserved. 

$2440 LOAD Load file. 

$2444 SETEXT Set default extension. 

AO should point to the FCB where you want to install the 
default extension. DO to contain the code character of 
the extension. If the file specification does not 
already have an extension, the extension code in DO will 
be installed. All registers are preserved. The 
following are legal extension codes, all others are 



ignored. 










- BNY 


6 


- SRC 


12 


- RCM 


1 - TXT 


7 


- DAT 


13 


- REL 


2 - COM 


8 


- BAC 


14 


- MUS 


3 - BAS 


9 


- DIR 


15 


- PIC 


4 - SYS 


10 


- PRT 


16 


- GIF 


5 - BAK 


11 


- OUT 







$2448 OUTDEC Output decimal number. 

Will output as a decimal number the binary number 
contained in DO. If Dl is = $FF then the decimal number 
will be output without any leading zeros or spaces. If 
Dl as then 9 digits will be output with leading zeros 
as spaces. If Dl = 1 thru 9 then 9-n digits will be 
output with leading zeros as spaces. The least 
significant digit will always be output. All registers 
except DO are preserved. 

$244C OUTHEX Output hexadecimal number. 

Will output 2 hex digits from a single byte pointed to 
by the Al register. On exit Al will be pointing to the 
next byte, DO will contain the last character printed, 
and all other registers are preserved. 

$2450 RPTERR Report error. See the Error Number List. 
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$2454 GETHEX Get hexadecimal number. 

Will read a hexadecimal number from the command line 
pointed to by LBPTR into DO. Reading will stop on the 
first non-hex character encountered. Return with NEG set 
indicates that no entry was made, carry will be set if 
any character, before the separator, was not a valid hex 
character. Carry will be clear if a valid hex number was 
found. All registers except DO & D7 are preserved. 

$2458 OUTADR Output address. 

Al points to a 4 byte address which will be output as 8 
hex digits. On exit Al points to the last byte plus one. 
All registers preserved except Al & DO. 

$245C INDEC Input decimal number. 

Will read a decimal number from the command line, 
pointed to by LBPTR, into DO as a binary number. Reading 
will stop on the first non-decimal digit encountered. 
Return with NEG set if no entry, carry will be set if 
any character, before the separator, was not a valid 
numeric character and LBPTR will be advanced to the next 
separator character, which will be in DO. Carry will be 
clear if a valid decimal number was found. All registers 
except DO & D7 are preserved. 

$2460 DOCMND Call REX as subroutine. 

$2464 STAT Keyboard check. 

The status of the keyboard is checked and if busy, not 
equal zero is returned. All registers, except D7 are 
preserved . 

$2468 INCHNE Input character w/o echo. 

$246C PDATA Print string w/o CR/LF. 
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$2FOO PINIT Initialize printer #1. 
$2F04 PCHEK Check if printer #1 busy. 
$2F08 POUT Output to printer #1. 
$2F0C PINIT2 Initialize printer #2. 
$2F10 PCHEK2 Check if printer #2 busy. 
$2F14 POUT2 Output to printer #2. 
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FILE MANAGEMENT SYSTEM ROUTINES 

The File Management System is the link between the DOS and the 
Disk. It takes care of all the housekeeping without any concern of 
the user. Access to the FMS is through the File Control Block (FCB). 
A FCB is a block of 320 bytes of memory and is addressed as follows: 



Byte Description 

Function Code 

1 Error code 

2 Status 

3 Drive number 
4-11 File name 
12-14 Extension 

15-16 MSW of link pointer 

17-16 Starting File address 

19-20 Ending File address 

21-22 File size 

23 File Sector Map 

24 Assigned drive # 
25-27 File Creation Date 
28-29 FCB link pointer 
30-31 Current T&S 
32-33 Current Record # 

34 Data Index 

35 Random Index 
36-46 Name Buffer 

47-49 Current Directory Address 

50-52 First Deleted Directory Pointer 

53-63 Scratch 

59 Space Compression Flag 

64-319 Sector Buffer 
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ENTRY POINTS TO FMS 

$3004 FMSCLS Close all files. Restore the I/O vectors and clear the 
SIR TABLE 



$3008 FMS Call FMS. A valid function code must be in Byte of 
the FCB and AO must be pointing to the FCB. The 
following Function Codes are valid. 



FC DESCRIPTION 

Read or Write next byte 

1 Open for Read 

2 Open for Write 

3 Open for Update 

4 Close file 

5 Rewind file 

6 Open Directory 

7 Get Information Record 

8 Put Information Record 

9 Read Single Sector 

10 Write single Sector 

11 Extend Directory 

12 Delete File 

13 Rename File 

15 Next sequential sector 

16 Open System Information Record 

17 Get Random Byte from Sector 

18 Put Random Byte in Sector 

19 Open & Extend file 

20 Find next drive 

21 Position to Record N 

22 Backup one Record 
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REGISTER USAGE 

In any calls to FMS , AO must be pointing to the FCB. AO is 
preserved and if you don't need it for something else, you can set it 
once and forget it. 

Al is not preserved. It is the source register, it must be pointing 
to the data to be output etc. It will also be used to output error 
messages . 

A2 thru A6 are always preserved in any calls to REXDOS. 
DO is used to pass data to and from REXDOS. It is not preserved. 
Dl is used as a error flag and modifier, it is not preserved 
D7 is scratch and not preserved. D2 thru D6 are preserved. 



USER COMMAND TABLE 

Memory-resident routines can be accessed thru the User Command 
Table. The command table address is put at USRCMD ($2312). 

The file spec in the user command table must be 8 bytes long, 
the 8th byte must be $0. For example; 

DC.B 'REW r ,0,0,0,0,0 
DC.L <VECT0R TO REW> 
DC.B 'RENAME 1 , 0,0 
DC.L RENAME 

DC.B Terminate table with $0 
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UTILITY COMMAND GROUP 

The following conventions will be used in describing the 
Utilities and the Syntax to use them. 

< > Mandatory entry 
[ ] Optional entry 

( ) Do not enter, inserted only for clarity 

: necessary to separate 2 or more commands on a command line. 
X Any alpha or numeric character 
filename The name of a file or utility 

filespec The drive #, filename, and extension of a file or program 
drive The drive # to be used 

drive list A list of one or more drive # separated by comas 
match list A set of names or extensions which will limit the 

execution of the program to only those files which 

match the names in the match list 
command A collection of filespecs and other data to instruct REX 

to do something 
command line A list of one or more commands 

Most Utilities will display a help message if the syntax is 
wrong of if a (?) is substituted for the filespec or drive #. 



*#*#*ACAT***** 
Alphabetized LIST OF DIRECTORY 4 COLUMNS WIDE 
Syntax: ACAT<, drive> 



##### APPEND***** 

CONCATENATE TWO OR MORE FILE TO MAKE ANOTHER FILE 

Syntax: APPEND, <filespec>[ , filespec] ,<filespec> 

The last filespec is the output file and will contain all of the 
preceding files. 



*#*#*ASN***** 

REPORT OR ASSIGN THE SYSTEM AND WORK DRIVES 

Syntax: ASN[ ,W=<drive>] [ ,S=<drive>] 

Without any arguments ASN will report the system and work drive 
numbers. With either or both arguments it will assign new drive 
number to the work or system drive numbers. See SYSTEM & WORK. 
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#*tt**BNY2S123***** 

MAKE A MOTOROLA FORMAT FILE FROM A REX BINARY FILE 

Syntax :BNY2S 123, <filespec> 

Depending upon the load address of the file, the SI, S2 or S3 
format will be used. If a Transfer address is in the file then an 
S7, S8 or S9 record will terminate the file. 



*****BORDERC***** 

SET THE BORDER COLOR 

Syntax: BORDERC , [color #] 

The default color # is 0(no color). Other colors are l=blue, 
2=green, 3=light blue, 4=red, 5=magenta, 6=yellow and 7=white. 

*****CASHON (REXK5 only)***** 

TURN CACHE ON 

SyntaxrCASHON 
The Cache will be turned oh if available. 



*****CASHOFF (REXK5 only)***** 

TURN CACHE OFF 

The Cache will be turned off. 



#*#**CAT***** 
LIST THE DIRECTORY OF SELECTED DRIVE 

Syntax:CAT[ ,<drive lis t>] [ , <match list>] 

The default drive is Work drive and if no match list is entered 
then all files on the drive will be listed. The match list will 
limit the listing to only the files which are matched. A number of 
options are available, if you enter CAT + a help message will be 
displayed and the options listed with the current settings. The 
options are: 

A Alphabetize the listing. 

D Display the creation date of file 

F Display the File number. 

M Display with F,S,D options. 

N Include non-existant file in listing 
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P Paging 
R Repeat 

S Display file size. 

For example: CAT+ADF , 1 , . COM would display all the .COM files 
on drive #1 in alphabetical order along with the file number and the 
creation date. 



#*tt##CGS***** 

CLEAR THE GRAPHICS SCREEN 

SyntaxrCGS , [color #] 

The Graphics Screen will be cleared 
The default color # is l=blue. Other colors are 2=green, 3=light 
blue, 4=red, 5=magenta, 6=yellow and 7=white. 

CHECK***** 

CHECK TO SEE IF TWO FILES ARE IDENTICAL 

Syntax : CHECK , <f ile spec > , <filespec> 

The program will report that either the two files are identical 
or that they do not match. 

#tttttt*CMPBNY***** 

COMPARE TWO BINARY TYPE FILES 

Syntax: CMPBNY , <f ilespec> , <f ilespec> 

The two files will be compared and any differences will be 
reported on the screen. 

*tt*tt#cMPMEM***** 

COMPARE A FILE AGAINST MEMORY 

Syntax : CMPMEM , <f ilespec> 

The file is checked against memory and any differences are 
reported on the screen. 

COPY***** 

COPY FILES FROM ONE DRIVE TO ANOTHER DRIVE 
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Syntax:COPY[ ,X] , <f ilespec> , <f ilespec> 
: COPY I ; ,X] ,<filespec>,<drive> 
:COPY[ ,X] ,<drive>,<drive>[ ,matchlist] 

There are three different forms of the Copy utility and in 
addition there are a number of options which can be set. The options 
are : 

A Copy in alphabetical order 

C Allow corrupt files to be copied 

D Copy files with a newer date 

E , Delete the existing destination file 

F Copy files by number 

K Kill duplicate file on source 

L List files without copying 

N Copy files not on the destination drive 

Turn off the default options 

P Prompt before copying 

R Recover file from Track-Sector 

S Make a second copy of file 

U Use the current DOS date 

W Wait for disk change 

Z Zap source file after copying 

For example: COPY ,DL , , 1 SRC would list the files with a later 
date and a .SRC extension on drive #0, that are on drive #1, 



CLEAR THE SCREEN 
SyntaxrCS 



*****CURS0RC***** 

CHANGE THE CURSOR COLOR 

SyntaxrCURSORC, [color #] 

The default is 77=white. Other colors are ll=blue, 22=green, 
33=light blue, 44=red , 55=magenta and 66=brown 

•fcttttttttDATE****** 

DISPLAY OR CHANGE THE SYSTEM DATE 

S y n t a x : DATE [ , MM , DD , Y Y ] 

For example: DATE will display the current system date. 
DATE, 01, 01, 90 Will set the system date to Jan 1, 1990. 
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DELETE***** 

DELETE FILE FROM DISK 

Syntax : DELETE, <filespec> 

There is no default extension you must include an extension in 
the filespec. The filespec will be displayed on the screen and you 
will be given the opportunity to abort. 



#****DISKNAME***** 

SERVICE THE DISK NAME, EXTENSION AND CREATION DATE 

Syntax: DISKNAME, <drive> 

The current name, extension and creation date of the disk in the 
selected drive will be displayed. You have the option to change it. 
If you answer "Y" you are asked for the new name, extension, and 
date. No entry (C/R) will keep the current entry. 



*****DRIDE (REXK4 only)***** 
Syntax: DRIDE 

Combined Disk driver for both MFM and IDE drives. 



***** DRIVESET***** 
DRIVESET Will service the Drive Information Table (DIT). 
Syntax : DRIVESET [ ,(X)] 

If DRIVESET (no (X)) is entered, the DIT currently in REX will 
be loaded. If a character (0-9, A-Z) is entered after a comma (,) 
then DRIVESET will load a file DRIVE(X) from the Work Drive. If a 
(?) is entered then a Help message will be displayed. 

DRIVESET will ask for a Logical Drive #. Enter the desired 
number and press the Return Key. A mask will be displayed on the 
screen, and depending upon the type of drive, will display the 
current drive info as normal bright characters. The low intensity 
characters will describe the data for the selected drive. A 5.25" 
high density drive will appear as follows: 

00: LOGICAL DRIVE #. ($FF = DESELECTED) 

00: TYPE FLAG. (A0=HARD, 0=QUAD, 1=FAST, 2=RAM 

00:DRIVE # (0 - 1) 

03:SRT STEP RATE (1 ms INCREMENTS) 

01.-HLT HEAD LOAD TIME IN 2 ms INCREMENTS (BIT #7 IS 3.5" FLAG) 
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14:GPL GAP4B (WRITE GAP AFTER DATA) 
12:MAX SECTORS/TRACK FOR DOUBLE DENSITY 
1C:MAX SECTORS/TRACK FOR HIGH DENSITY 

THE HI-LITED HEX BYTES ON THE LEFT ARE THE PARAMETERS FOR THE 
SELECTED DRIVE. YOU MAY CHANGE THEM BY MOVING THE CURSOR TO THE 
POSITION AND ENTERING THE NEW HEX DATA. THE NEW DATA WILL BE PLACED 
IN MEMORY. YOU MAY NOW SELECT OTHER DRIVES OR C/R WILL DISPLAY THE 
COMPLETE TABLE 

If you press the RETURN key instead of selecting a drive, the 
display of all 10 drives will be put on the screen. Two other hex 
addresses are also displayed. The track buffer address for the 1772 
disk controller and the track buffer address for the 37C65 disk 
controller. Both of these addresses are set just below 1/2 megabyte 
which is the minimum memory you can have. If you have more memory 
and want to move these buffers enter the new hex addresses and enter 
a control R. 

Control X will return to REX without creating a DRIVE(X) file. 
Control S will ask for the character to name DRIVE and then save the 
new DRIVE(X) file on the Work drive. Assuming that you selected the 
character "A", if you type (#).DRIVEA, the new data will be put in 
the DIT. Control P will print a copy of the DIT if your printer is 
active . 

If you have more than 10 drive devices (I have 16) you can use 
DRIVE(X) routines to move these drives on line or off line as you see 
fit. You might have a special disk which has a special DRIVE(X) 
routine to access a hidden partition on your hard drive that no one 
else knows about. 



The DIT that is supplied with REXK5 is as follows: 



LD 


TP 


B2 


B3 


B4 


B5 


B6 


B7 


REMARKS 






00 


00 


00 


03 


81 


10 


12 


22 


3.5" HD DRIVE PHY #0 , 


LOG #0 


FF 


00 


01 


03 


01 


14 


12 


1C 


5.25" HD DRIVE PHY #1 


, LOG #1 


FF 


AO 


22 


88 


01 


98 


00 


00 


HARD DRIVE 


STARTING @ 


CYL #0 


FF 


AO 


22 


88 


00 


88 


00 


32 


HARD DRIVE 


STARTING § 


CYL #50 


FF 


AO 


22 


88 


00 


88 


00 


82 


HARD DRIVE 


STARTING § 


CYL #130 


FF 


AO 


22 


88 


00 


88 


00 


D2 


HARD DRIVE 


STARTING @ 


CYL #210 


FF 


AO 


22 


88 


00 


88 


01 


22 


HARD DRIVE 


STARTING § 


CYL #290 


07 


02 


00 


10 


00 


00 


00 


10 


RAM DRIVE 


$100000 - 


$2FFFFF 


FF 


AO 


22 


99 


01 


98 


01 


32 


HARD DRIVE 


STARTING § 


CYL #306 


FF 


02 


00 


20 


00 


00 


00 


20 


RAM DRIVE 


$200000 - 


$3FFFFF 



37C65 TRACK BUFFER ADDRESS $7BC00 17,408 BYTES 



1772 TRACK BUFFER ADDRESS $00000 BYTES 

The DIT that is supplied with REXK4 is as follows: 
LD TP B2 B3 B4 B5 B6 B7 REMARKS 
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00 


00 


00 


03 


01 


14 


12 


1C 


FF 


00 


01 


03 


81 


10 


12 


22 


FF 


01 


07 


20 


20 


FF 


OA 


12 


FF 


80 


22 


88 


00 


88 


00 


00 


FF 


80 


22 


88 


00 


88 


00 


64 


FF 


80 


22 


88 


00 


88 


01 


OE 


FF 


80 


22 


88 


00 


88 


01 


B8 


00 


02 


00 


01 


00 


00 


00 


06 


FF 


01 


07 


21 


21 


FF 


OA 


12 


FF 


01 


07 


22 


22 


FF 


OA 


12 



5.25" HD DRIVE PHY #0, LOG #0 
3.5" HD DRIVE PHY #1, LOG #1 
5.25/3.5" 720k DRIVE P0,L2 
HARD DRIVE STARTING § CYL #0 
HARD DRIVE STARTING § CYL #100 
HARD DRIVE STARTING @ CYL #270 
HARD DRIVE STARTING § CYL #440 
RAM DRIVE FROM $10000 - $6FFFF 
5.25/3.5" 720K DRIVE P1.L8 
5.25/3.5" 720K DRIVE P2.L9 

37C65 TRACK BUFFER ADDRESS $7D800 10,240 BYTES 

1772 TRACK BUFFER ADDRESS $7C000 6,144 BYTES 

The detailed information about the Hard drive will be in the 
HFORMAT and IFORMAT Utilities and the RAM drive info will be in the 
TURBO utility. 

**###DUMP**#** 
HEX AND ASCII DUMP OF A FILE 

Syntax : DUMP< , f ilespec> 

The default extension in .BNY. A display of each sector of the 
file will be displayed on the screen in lines of 16 hex characters 
and on the right their Ascii equivalents. 

***#*DUP##**# 

WILL LIST FILES IN FIRST DIRECTORY THAT ARE NOT IN SECOND 
DIRECTORY. 

Syntax:DUP , <drive> , <drive> 

*##*#ECH0***** 

WILL ECHO A STRING TO THE OUTPUT DEVICE 

Syntax:ECHO ,<string> 

String is a list of ascii character terminated by a c/r or EOL 
character. For example, ECHO, Hello World(c/r) would print on the 
screen "Hello World". 

##***EDD****' 5f ' 

MINI EDITOR 
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Syntax:EDD,<f ilespec>[ ,<output filespec>] 

The default extension is .TXT, the default drive is the working 
drive. EDD will display a message and then load the requested file, 
if that file does not exist EDD will create a new file with that 
name, clear the screen and display a c/r at the home position and 
then the cursor. The following commands are available: 

CTL "I": Insert text at cursor to limit of buffer 

CTL INS: Insert one line of text 

CTL DEL: Delete line containing the cursor 

INS: Insert 1 space at cursor position 

DEL: Delete 1 character at cursor position 

CTL "E": Enter edit mode (Overlay) 

CTL "Q": Return to DOS saving the text 

"?": Display command instructions 

ESC: Stop and return to command mode 

CTL "X": Return to DOS without save 

LF ARROW: Will move cursor left 1 position 

DN ARROW: Will move cursor down 1 line 

RT ARROW: Will move cursor right 1 position 

UP ARROW: Will move cursor up 1 line 



WILL EJECT THE PAPER ON PRINTER #1 
Syntax: EJ 



tttttt*#EPBURN***** 

COMMUNICATIONS PROGRAM TO WORK THE BP MICROSYSTEMS EP-1 EPROM 
BURNER. 

Syntax:EPBURN 
The EP-1 must be connected to COM3. 



*****EXAMINE***** 

A FULL FEATURED DISK REPAIR UTILITY 

Syntax : EXAMINE, <drive> 

Examine will read the SIR and ask if the Track & Sector values 
are acceptable. The prompt "COMMAND" is issued and the following 
command are available: 

R,<sector address> Read a Sector 
W,<sector address> Write a Sector 
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D,<sector address> Read & display a sector 
C,<sector address> Read & display to EOF 
M,<byte number> Modify sector buffer 

F,<filespec> Read first sector of a file 

B,<filespec> Build link table for a file 

T,<addr>,addr>, <count> move data in memory 
S Return to REXDOS 

The sector address is in the form of TTSS where TT is the Track 
and SS is the sector in hexadecimal format. Several other modifiers 
are available to help trace files: 

+ Will get the next physical sector. 

Will get the previous physical sector 
N Will get the next logical sector 
P Will get the previous logical sector 
= Will keep the current sector 



*****EXEC***** 

PROCESS A LIST OF COMMANDS 

Syntax : EXEC ,<filespec> 

The default extension is .TXT. Use EDD or EDDI to create a file 
containing several commands and EXEC will run the commands just as if 
you have typed them from the keyboard. For example: 

Prepare a file named ALLCAT.TXT like this on the Work drive; 

ECHO, All cat 
ACAT,0 
ACAT, 1 
ACAT,7 

Enter EXEC , ALLCAT 

The screen should print "All cat 11 and then list all the files in each 
drive separately in alphabetical order. 

***** FORMAT***** 

FORMAT A HD DISK, 1.2 OR 1.4 MEGABYTES 

Syntax: FORMAT ,<drive> 

If the drive # is missing or is illegal (?) a help message will 
be displayed. Your are asked for a "Disk Name", enter up to 8 
characters. Next for a Volume number if you don't enter a Volume # a 
random number will be assigned. If a HD or Quad Disk is not 
installed at the logical drive # entered you will be informed. Now 
the Physical drive # will be displayed on the screen and you must 
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verify that it is correct. 

The disk will be formatted with 80 tracks. Then it will be 
verified to see that all the data is correct. If any byte in a track 
is bad then that track is unlinked from the free chain of sectors and 
will not cause any trouble. The disk name extension will be .QDF 

In order for a disk to be properly formatted, the correct 
information must be in the DIT. Correct entries for the HD disk are: 

LD TP B2 B3 B4 B5 B6 B7 REMARKS 

00 00 01 03 81 10 12 22 3.50" HD DRIVE PHY #0, LOG #0 

01 00 00 03 01 14 12 1C 5.25" HD DRIVE PHY #1, LOG #1 



*****F0RMATDD (REXK4 only) ***** 

F0RMATT A 720K DOUBLE DENSITY DISK IN A HD TYPE DRIVE 

Syn tax : FORMATDD, <d rive > 

If the drive # is missing or is illegal (?) a help message 
will be displayed. Your are asked for a "Disk Name", enter up 
to 8 characters. Next for a Volume number if you don't enter a 
Volume # a random number will be assigned. If a HD drive is not 
installed at the logical drive # entered you will be informed. 
Now the Physical drive # will be displayed on the screen and you 
must verify that it is correct. 

The disk will be formatted with 80 tracks, 720K, 18 sectors 
per track. Then it will be verified to see that all the data is 
correct. If any byte in a track is bad then that track is 
unlinked from the free chain of sectors and will not cause any 
trouble. The disk name extension will be .DDF 



*****HARD (REXK4 only)******* 

Disk driver for the ST-225,251 hard disk or similar drives. 
For systems that boot from a floppy disk, HARD must be installed 
before any access to the hard disk. For systems that boot from 
the hard disk, HARD must be appended to REXK4H.COM and the 
combined file linked on the hard disk at cylinder #0 and sector 
1. Obviously the hard disk must be working from the floppy disk 
before you can prepare to boot from the hard disk. The hard 
disk must be formatted with HF0RMAT before it can be used. 

Exampl e : APPEND . REXK4H . COM , . HARD . COM , . REXD0 S . SYS 

*****HF0RMAT (REXK4 only)***** 
Formatt a hard disk partition. 
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Syntax:HFORMAT,<drive #> 

The partition on the hard disk will be formatted according 
to the contents of the DIT for the logical drive # specified. 
If the logical drive is not a hard drive the program will be 
aborted . 

Setting up a hard disk is quite a problem. Rex can only 
address 16 megabytes of data so inorder to use all of a hard 
drive you must partition the disk into 2 or more drives. A 
typical Hard drive (ST-225) has 34 sectors on each track and 4 
tracks per cylinder (4 heads). The maximum number of cylinders 
that can be addressed is 255 which only allows about 8.8 megs 
per partition. You could increase the size of the partition by 
having more Logical Sectors per Track. This should be a 
multiple of 34 ($22). The current value is 136 ($88) and the max 
value could be 238 ($EE). 

You must decide how many partitions and how many cylinders 
you want for each partition. Since HO, the first partition, 
will be used for the boot and probably be the system drive it 
doesn't have to be very large. The setup included on the System 
disk sets HO to 100 cylinders, H2 & H3 to 170 cylinders and H4 
to the rest of the drive, 174 cylinders. The max cylinder number 
is 615. 

You must now create a DRIVE(X), let's call it DRIVEH, to 
use when you are using the hard drive. I suggest that you use 
HO as L0, Ql as LI, Q0 as L2 , HI as L4 , H2 as L5 , H3 as L6 and 
RAM as L7. The others are not installed ($FF). Type DRIVEH to 
install the new DIT and then enter 2. SYSTEM, 2. This will make 
drive #2 the system drive and it will contain your system disk. 

Go ahead and enter HF0RMAT,0. It will take some time to do 
the low level . formatting and then link and test all the sectors. 
If some sectors are bad don't get upset as most hard drives do 
have some bad sectors. REX will unlink the bad sectors and you 
will never know about them again. If you have not installed 
HARD do so at this time. Now you may CAT,0 and see how many 
sectors you have. You might also want to COPY 2,0 to get all the 
utilities over on the Hard drive. If you set SYSTEM, you will 
be surprised how much faster everything runs. If everything is 
successful go ahead and format the other Hard drives. 

If you need to reserve space for another operating system 
on the Hard disk, such as 0S-9, you will need to set up a dummy 
hard partition with the offset of the reserved area. HFORMAT 
will search the DIT for any offset greater than its starting 
cylinder and use the smallest offset as the partition limit. Of 
course do not format this dummy partition. 

To boot the system put a system disk in L0 and enter "V". 
Now enter HARD and then DRIVEH. Now go read about UPSTART which 
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will do that for you. 



WILL ECHO TO THE OUTPUT DEVICE THE HEX CHARACTERS THAT FOLLOW 

SyntaxrHECHO ,<hex string> 

Hex string is a list of hexadecimal characters 
For example, HECHO ,D , A , 48 , 65 , 6C , 6C , 6F , 7 

Would output the c/r and 1/f then print "Hello"- and ring the bell. 

Disk driver for the ST-3120 IDE hard disk or similar drives. 
For systems that boot from a floppy disk, HIDE must be installed 
before any access to the hard disk. For systems that boot from the 
hard disk, HIDE must be appended to REXK7I.COM and the combined file 
linked on the hard disk at cylinder #0 and sector 1. Obviously the 
hard disk must be working from the floppy disk before you can prepare 
to boot from the hard disk. The hard disk must be formatted with 
IFORMAT before it can be used. 

Example: APPEND . REXK7I . COM, . HIDE . COM, . REXDOS . SYS 

To boot from a Hard drive at a partition other than cylinder #0 , 
or if the DIT parameters are different from the REXK7I DIT, the DIT 
for REXDOS must be overlayed with the current table. Get the Hard 
drive working from a floppy drive with all your partitions etc. 
Now save a copy of the DIT with 'SAVE 1 .DITI .BNY , $3B00 , $3B60 T . To 
create the REXDOS for the Hard drive enter; 

f APPEND 1 . REXK ?I . COM , 1 . DITI . BN Y , 1 .HIDE . COM , 1 . REXDOS . SYS T 

Copy REXDOS. SYS to drive 0, LINK it and then use LINKIDE to tell 
the boot where to find it. 

To boot the system from a floppy drive, put a system disk in L0 
and enter "V". Now enter HIDE and then DRIVEI. Now go read about 
UPSTART which will do that for you. 
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tt#tt#ttIFORMAT***** 

Formatt an IDE hard disk partition. 

Syntax:IFORMAT ,<drive #> 

The partition on the hard disk will be formatted according to 
the contents of the DIT for the logical drive # specified. If the 
logical drive is not a hard drive the program will be aborted. 

Setting up a hard disk is quite a problem. Rex can only address 
16 megabytes of data so in order to use all of a hard drive you must 
partition the disk into 2 or more drives. A typical IDE drive (ST- 
3120) has 34 sectors on each track and 12 tracks per cylinder (12 
heads). This works out to be 408 Sectors per Cylinder ($198). The 
maximum number of logical tracks that can be addressed is 255. You 
could increase the size of the partition by having more Logical 
Sectors per Track. This should be a multiple of 34 ($22). A value of 
136 ($88) will give an 8.8 megabyte partition and the value of 238 
($EE), about a 15 megabyte partition . The max value is 254 ($FE), it 
must be even as IDE sectors are 512 bytes and ours are 256. 

You must decide how many partitions and how many cylinders you 
want for each partition. Since HO, the first partition, will be used 
for the boot and probably be the system drive it doesn't have to be 
very large. Two sample DITs are shown below and included on the 
System disk as DRIVEJ and DRIVER, they set HO to 50 cylinders, about 
5 megs. HI thru H6 to 148 cylinders and H7 to the rest of the drive, 
86 cylinders. The max cylinder number is 1024. 

You now use DRIVESET to create a DRIVE(X), let's call it DRIVEI, 
to use when you are using the hard drive. I suggest that you use HO 
as L0, Ql as LI, HI as L2 , H2 as L3 , H3 as L4 , H4 as L5 , H5 as L6, 
RAM as L7, H6 as L8 & H7 as L9. The entries under TP(type) are AO for 
Master Drive and BO for Slave drive. Type DRIVEI to install the new 
DIT and then enter 1. SYSTEM, 1. This will make drive #1 the system 
drive and it will contain your system disk. 

Go ahead and enter IFORMAT , 0. You will be asked for the Last 
cylinder #, the default is 1024, but you may limit the format to any 
cylinder. If you enter a C/R the last cylinder will be calculated 
from the DIT. The starting and ending cylinder numbers will now be 
displayed and you may abort if necessary. It will take some time to 
do the high level formatting and then link and test all the sectors. 
If some sectors are bad don't get upset as most hard drives do have 
some bad sectors. REX will unlink the bad sectors and you will never 
know about them again. If you have not installed HIDE do so at this 
time. Now you may CAT,0 and see how many sectors you have. You might 
also want to COPY 1,0 to get all the utilities over on the Hard 
drive. If you set SYSTEM, you will be surprised how much faster 
everything runs. If everything is successful go ahead and format the 
other Hard drive partitions. 

To reserve space for another operating system on the Hard disk, 
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such as OS-9 or MSDOS, which uses cylinder #0. sectors 1 & 2 for its 
boot loader, start the REX partitions at a higher cylinder to leave 
space for the other operating systems. LINK REXDOS as usual on HO and 
then use LINKIDE a program that will put the DIT of the selected 
drive # at location $F4 of sector 2, Cylinder 





SAMPLE 


DIT 


(DRIVEJ) 


with 3 


5" 


1.4 meg drive at 


physical 


#0 


LD 


TP 


B2 


B3 


B4 


B5 


B6 


B7 


REMARKS 










00 


AO 


22 


88 


01 


98 


00 


00 


IDE 


DRIVE 


STARTING § 


CYL 


#0 


HO 


01 


00 


00 


03 


81 


10 


12 


22 


3.5' 


" HD DRIVE PHY #0, 






QO 


02 


AO 


22 


EE 


01 


98 


00 


32 


IDE 


DRIVE 


STARTING @ 


CYL 


#50 


HI 


03 


AO 


22 


EE 


01 


98 


00 


C6 


IDE 


DRIVE 


STARTING § 


CYL 


#198 


H2 


04 


AO 


22 


EE 


01 


98 


01 


5A 


IDE 


DRIVE 


STARTING § 


CYL 


#346 


H3 


05 


AO 


22 


EE 


01 


98 


01 


EE 


IDE 


DRIVE 


STARTING § 


CYL 


#494 


H4 


06 


AO 


22 


EE 


01 


98 


02 


82 


IDE 


DRIVE 


STARTING § 


CYL 


#642 


H5 


07 


02 


00 


08 


00 


00 


00 


08 


RAM 


DRIVE 


FROM $8000C 


1 - ! 


$FFFFF 


08 


AO 


22 


EE 


01 


98 


03 


16 


IDE 


DRIVE 


STARTING § 


CYL 


#790 


H6 


09 


AO 


22 


88 


01 


98 


03 


AA 


IDE 


DRIVE 


STARTING @ 


CYL 


#938 


H7 



37C65 TRACK BUFFER ADDRESS $7BC00 17,408 BYTES 
1772 TRACK BUFFER ADDRESS $00000 BYTES 

SAMPLE DIT (DRIVEK) with 5.25", 1.1 meg drive at physical #0 



LD 


TP 


B2 


B3 


B4 


B5 


B6 


B7 


REMARKS 












00 


AO 


22 


88 


01 


98 


00 


00 


IDE 


DRIVE 


STARTING 


§ 


CYL 


#0 


HO 


01 


01 


00 


03 


01 


14 


12 


1C 


5.2S 


<" HD DRIVE PHY 


#0, 




QO 


02 


AO 


22 


EE 


01 


98 


00 


. 32 


IDE 


DRIVE 


STARTING 


§ 


CYL 


#50 


HI 


03 


AO 


22 


EE 


01 


98 


00 


C6 


IDE 


DRIVE 


STARTING 


§ 


CYL 


#198 


H2 


04 


AO 


22 


EE 


01 


98 


01 


5A 


IDE 


DRIVE 


STARTING 




CYL 


#346 


H3 


05 


AO 


22 


EE 


01 


98 


01 


EE 


IDE 


DRIVE 


STARTING 


§ 


CYL 


#494 


H4 


06 


AO 


22 


EE 


01. 


98 


02 


82 


IDE 


DRIVE 


STARTING 


§ 


CYL 


#642 


H5 


07 


02 


00 


08 


00 


00 


00 


08 


RAM 


DRIVE 


FROM $80000 - 


$FFFFF 


08 


AO 


22 


EE 


01 


98 


03 


16 


IDE 


DRIVE 


STARTING 


e 


CYL 


#790 


H6 


09 


AO 


22 


88 


01 


98 


03 


AA 


IDE 


DRIVE 


STARTING 


§ 


CYL 


#938 


H7 



37C65 TRACK BUFFER ADDRESS $7BC00 17,408 BYTES 

1772 TRACK BUFFER ADDRESS $00000 BYTES 

In case your IDE drive has more capacity than you can get in 1 
DIT, you should split the partitions into 2 or more DITs. It is easy 
to have several DITs to use for different programing functions. 
There is no need to have access to your source code when you are 
doing business tasks. I would suggest that you keep the original 
DITs that were used to format the IDE drive in a safe place in case 
you have to reformat some time. Ron Anderson has a set of routines 
that let you change partitions just as you change directories in 
MSDOS (CD) and he will be writing about them soon. 
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*tt#tt#KEYCHEK***** 

WILL DISPLAY IN HEX AND ASCII THE ACTUAL CHARACTER RETURNED FROM 
A KEY PRESS. 

Syntax: KEYCHEK 

Control f, C ff is the exit character and as a result it can't be 
checked. It is an $03. Don't Try the PAUSE or Control NUMLOCK on 
the PC keyboard or the Control Break on a terminal keyboard. If you 
are writing a program and want to use the Editing or Function keys, 
this routine will tell you what character will be returned in DO 
after a call to Trap #1. 



ttttttttttKRACK***"** 
DISASSEMBLER FOR MEMORY OR KEYBOARD ENTRY 
Syntax:KRACK 

A menu will be displayed and you may choose your options. 



ttttttttttLiNK***** 

LINK TRACK SECTOR 1 TO THE FILE 

Syntax: LINK , <f ilename> 

In order to load the operating system (REXDOS), its address on 
the disk must be put in Track 0, sector 1, so the loader knows where 
to start. For example: LINK , . REXDOS .COM . The default extension is 
.SYS. Any file can be linked so that other operating systems or 
programs can be loaded. The program to be loaded must be in REX 
binary format. 

*****LINKHARD (REXK4 only)**** 

Syntax:LINKHARD,<drive #> 

This routine is used when the REX partition is not located at an 
offset of $00. The offset to the REX partition is put at Cylinder 
#0, Sector #2, Byte $F4. 

#****LINKli)E**** 

Syntax:LINKIDE,<drive #> 

This routine is used when the REX partition is not located at an 
offset of $00. The offset to the REX partition is put at Cylinder 
#0, Sector #2, Byte $F4. 
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#####L]!ST***** 
SEND A FILE TO THE OUTPUT DEVICE 
Syntax: LIST ,<filespec> 

The default extension is .TXT. You may optionally enter a Title 
to be printed on each page. 



##*##MAP***** 

LIST THE BEGINNING AND ENDING ADDRESSES OF EACH SEGMENT OF A 
BINARY TYPE FILE. 

Syntax :MAP , <f ilespec> 

The default extension is .BNY 



*####MEMEND***** 

SERVICE THE MEMORY END POINTER 

Syntax :MEMEND[ ,<address> 

Without any arguments MEMEND will display the current Memory End 
Address in REX. I you put a Hex Address after the comma that address 
will now become the last available address for REX or programs that 
run under REX. For example: MEMEND, 3FFFF will permit REX to use 
256K of memory, reserving the rest for other purposes. 



*****MAKDISK (REXK4 only)***** 

FORMAT A 720K DISK IN THE 1772 TYPE DISK CONTROLLER WITH 1:1 
INTERLEAVE 

Syntax :MAKDISK , <drive> 

Enter the Disk name and then the preset options will be 
displayed you may accept them and continue, or reject them and enter 
your own parameters. A disk formatted this way will run slower on 
the K2 and older machines. 



*****NEWDISK (REXK4 only)***** 

FORMAT A FLOPPY DISK FOR THE K2 AND OLDER COMPUTERS, USING THE 
1772 DC, WITH AN INTERLEAVE OF 3:1, AND OPTIONS FOR DENSITY, SIDES, 
AND TRACKS 

Syntax:NEWDISK 
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Enter the Disk name and then the preset options will be 
displayed you may accept them and continue, or reject them and enter 
your own parameters. A disk formatted this way will run much slower 
on the K4. 

ttttttttttOLOAD'***'**"* 

OFFSET LOADER 

Syntax:OLOAD,<filespec>[ ,<offset>] 

The default extension is .BNY. If no offset address is entered 
then the program will load at its normal address. Offsets can be 
either negative or positive. For example: OLOAD , . LIST . COM , 1000 
would put the LIST utility at $6000. 

PRINT AT 10 CHARACTERS PER INCH USING EPSON COMMANDS 

##*##P12STAR***** 
PRINT AT 12 CHARACTERS PER INCH USING STAR MICRONICS COMMANDS 

PROMPTING DELETE UTILITY 

Syntax:PDEL,<drive>[ ,<match list>] 

All file names that match will be displayed on the screen with 
the option to delete or continue. 

PRINT 12 CHARACTERS PER INCH ON PRINTER #2 

p jj 2#tttttt* 

PRINT NEAR LETTER QUALITY ON PRINTER #2 

PRINT NEAR LETTER QUALITY ON PRINTER #1 

*****PRINT(PRDVR)***** 
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PRINTER DRIVERS 

SyntaxrPRINT(XX) (PRDVR(XX)) 

The (XX) are two characters which determine the ports that 
printer #1 and printer #2 will use. There are 2 parallel ports on 
the Computer, PORTA and PORTB, and 4 Serial ports, C0M1, COM2, COM3, 
COM4. The addresses for these ports are in the memory map supplied 
with MONK. The printer driver that comes installed in REX is 
PRINTA2, meaning that printer #1 outputs on PORTA, a parallel 
interface, and printer #2 outputs on COM2, a serial interface. For 
example: PRINT43 would make printer #1 go to COM4 and printer #2 go 
to COM3. 



PRINT SMALL (16 CPI) ON PRINTER #1 (EPSON COMMANDS) 



PRINT SMALL (16 CPI) ON PRINTER #2 (EPSON COMMANDS) 



* # # # # g ^ W K E Y * * * * * 
DISPLAY PC KEYBOARD KEYPRESS DATA 
Syntax: RAWKEY 

DISPLAY ON A TERMINAL THE ACTUAL DATA RETURNED BY KEYPRESSES ON 
THE PC KEYBOARD. 



CHANGE FILE CREATION DATE 

Syntax:REDATE,<filespec>[ ,MM,DD,YY] 

If the date is omitted or bad then the current system date will 
be used. 

tt*#*#RENAME***** 

CHANGE THE NAME AND EXTENSION OF A FILE 

Syntax: RENAME ,<filespec>, <new f ilespec> 

The default extension is .TXT and the default drive is work 
drive. If no extension is given for the new filespec the old 
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filespec extension will be used. A drive # in the new filespec is 
ignored . 



•*****REVERSEC***#* 

SET REVERSE VIDEO COLOR 

Syntax:REVERSEC, [color #] 

Default is 71 white/blue characters. 24 = green/red , 42=re d/green , 
34=Blue/Red, 43=Red/Blue , 14=Blue/Red , 41=Red/Blue , other 
combinations are available. 



■fctttttt-KSAVE***** 

SAVE MEMORY AS A REX BINARY FILE OR AS A MEMORY IMAGE FILE 

Syntax:SAVE,<f ilespec> , <beg addr>,<end addr>[ , + ] [ tran addr] 

The default extension is .BNY, unless the (+) option is 
selected, when an extension of .MEM is forced. The transfer address 
is ignored if the (+) option is selected and if it is not included in 
a binary save the file will be saved without a transfer address. If 
the filespec exists on the destination drive you will be asked if you 
want to delete it. 



#tttt##SAVETEXT***** 
SAVE A TEXT FILE TO DISK 

Syntax:SAVETEXT,<filespec>,<beg addr>,<end addr> 
The data will be saved as a text file with space compression. 



ttttttttttsCAN***** 

A MINI SHELL PROGRAM FOR REX 

Syntax: SCAN, <drive> 

The default drive is the work drive. The disk directory is 
displayed in a mask and the following commands are active. 

C - Will copy the Entry under the Cursor from the Work Drive 

to the Designated Drive 
D - Will Delete the File under the Cursor and remove the Entry 

from the Catalog 
ESC Will Terminate Viewing and Return to the Catalog 
F - Will Execute a Rex Command. 

/ Will enter the File under the Cursor in the command line 
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H - Will display these Messages 

I - Will Install a Binary type File under the Cursor to the 

Designated Drive with a .COM extension 
V - Will View the File under the Cursor 
X - Will Exit to Rex 



tttt*tt*SET( XX 
INSTALL MODES TO THE VGA CONTROLLER CARD 
Syntax: SETXX 

The following routines were developed to test the VGA Mode 



selections i 


of 


Trap 


> #12. 








SET1 




Set 


Video 


Mode 


1 


40x25 Text 


SET3 




Set 


Video 


Mode 


3 


80x25 Text 


SETE 




Set 


Video 


Mode 


E 


640x200 Graphics 


SET10 




Set 


Video 


Mode 


10 


640x350 Graphics 


SET12 




Set 


Video 


Mode 


12 


640x480 Graphics 


SET13 




Set 


Video 


Mode 


13 


320x200 Graphics 


SET22 




Set 


Video 


Mode 


22 


132x44 Text 


SET23 




Set 


Video 


Mode 


23 


132x25 Text 


SET24 




Set 


Video 


Mode 


24 


132x28 Text 


SET26 




Set 


Video 


Mode 


26 


80x60 Text 


SET29 




Set 


Video 


Mode 


29 


800x600 Graphics 


SET2A 




Set 


Video 


Mode 


2A 


100x40 Text 


SET2D 




Set 


Video 


Mode 


2D 


640x350 Graphics 


SET2E 




Set 


Video 


Mode 


2E 


640x480 Graphics 


SET2F 




Set 


Video 


Mode 


2F 


640x400 Graphics 


SET30 




Set 


Video 


Mode 


30 


800x600 Graphics 


SET37 




Set 


Video 


Mode 


37 


1024x768 Graphics 


SET38 




Set 


Video 


Mode 


38 


1024x768 Graphics 


SET53 




Set 


Video 


Mode 


53 


80x50 Text 



###tt#SETPC***** 
PUT THE PC KEYBOARD AND VGA IN CONTROL 
Syntax: SETPC 

The Trap #1 and #2 vectors will now point to the PC keyboard and 
VGA screen routines. 

ttttttttttSETTERM****** 
PUT THE TERMINAL IN CONTROL 
Syntax: SETTERM 

The Trap #1 and #2 vectors will now point to the Terminal 
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routines . 



tttttfttttSETIME*****' 
SET THE CLOCK AND CALENDAR CHIP 
Syntax: SETIME 

A menu to start or stop the clock oscillator is displayed. If 
you are going to store the computer for a while or not use it. 
Turning the oscillator off will extend the battery life. You will be 
requested to enter the minutes, hours, am or pm, day of the week, day 
of the month, month, and year. When you press a character to start 
the clock it will start with the seconds at 00. Next the correction 
factor will be displayed and the opportunity to change it. Each 
correction will change 5.35 seconds per month. 



tttfttttttSLIDE***** 

DISPLAY PICTURE FILES 

Syntax: SLIDE , <File spec > , [Files pec] , [File spec] 

The default extension is .PIC. The Maximum number of files to be 
displayed is limited by the LINE BUFFER size of 128 bytes. The ESC 
chaaracter will return to DOS and any other character will display 
the next picture. Use EXEC to create a larger slide show. 

#tttt##SP00LA***** 

Syntax: SP00LA 

SP00LA is a printer driver for parallel port A which stores the 
characters to be printed in memory and returns to REX. When the 
printer is ready to accept a character it interrupts the computer for 
a few microseconds to get a character to print. This process 
continues until the document is finished. If you go to MONK or any 
other program which sets the interrupt mask to level 3 or higher the 
printing will stop until the mask is cleared. The memory from $80000 
to $FFFFF is reserved for Spooling. The SP00LA loads below $5000. 
Multiple documents can be sent to the spooler; however, if the 
document doesn f t do a form feed at the end you should do an EJ 
command between documents to start the next document at the top of a 
page. Caution, the RAM disk(TURBO) may conflict with SP00LA. 



tttttttt*SYSTEM***** 

SET THE SYSTEM DRIVE # 

Syntax:SYSTEM[ ,<drive>] 
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Without any arguments SYSTEM will display the current system 
drive #. 

tt#tttt#TCOPY*#*** 

A FAST COPY ROUTINE 

Syntax: TCOPY , <source drive>,<dest drive>[ ,matchlist] 

ttttttttttTEXTC***** 

CHANGE THE TEXT COLOR 

Syntax:TEXTC, [color #] 

The default is 0E=Black with Yellow characters. lE=Blue/yellow, 

lF=Blue/White, 4E=Red/Yellow , OF=Black/Whit e , 5F=Magenta/White , 

6A=Brown/Green , 70=Whi te/Black , 74=Whi te/Red , other combinations are 
possible . 

ttttttttfcTFRATE***** 

MEASURE THE TRANSFER RATE OF DISK READS 

Syntax : TFRATE , <f ilespec> 

The selected file will be read and the elapsed time, byte count, 
and transfer rate will be displayed. 

ttttttttttTIME***** 
DISPLAY THE TIME AND DATE 
SyntaxrTIME 

The time and date will be displayed on the screen. 

**tt*#TIMER***** 

MEASURE ELAPSED TIME 
SyntaxrTIMER 

The ESC key will return to DOS. Any other key will start and 
stop the timer. The elapsed time will be displayed in Microseconds. 

tt-x-ttttttTURBO****** 
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INSTALL A RAM DISK 

Syntax:TURBO,<drive #> 

If a drive # is not entered then the default drive #7 will be 
installed. If the drive # specified is not a RAM drive you will be 
informed. If the RAM disk has already been installed you will be 
informed and the current contents will be retained. 

Use DRIVESET to define the location of a RAM disk. Byte #1 must 
be $02 to be RAM drive. Bytes 2-5 are the Starting address of the 
RAM disk and bytes 6-7 are the number of 64K pages of memory to use. 
e.g 

LD TP B2 B3 B4 B5 B6 B7 REMARKS 

07 02 00 01 00 00 00 06 390K AT $10000 AS L7 

08 02 00 10 00 00 01 00 1 MEG AT $100000 AS L8 

The max size of a RAM disk is 4 megabytes. 



ttttttttttviEW****** 

VIEW A FILE 
Syntax: VIEW, <filespec> 

The default extension is .TXT, the default drive is the work 
drive. The selected file will be displayed on the screen. The down 
arrow will move forward one line and the up arrow will move the 
display backwards 1 line. The ESC will return to REX. 



tt####W0RK***** 

SET THE WORK DRIVE # 

Syntax:WORK[ ,<drive>] 
Without an argument WORK will display the current work drive #. 



•fcttttttttXTURBO***** 

UNINSTALL A TURBO DRIVE 

SyntaxrXTURBO ,<drive #> 

The drive # must be included. You will be asked if you want to 
delete the selected drive, a no answer will return to DOS. 



ttttttttttYEAR****** 
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DISPLAY OR CHANGE THE REX YEAR BYTE 

Syntax:YEAR[ ,YY] 

YEAR with out any parameters will display the current REX year 
byte. Followed by a hex number the REX year byte will be changed. 
For example YEAR ,89 would set the year byte to 1989. 



tttttt-fcttZAP***** 

DELETE ALL FILES ON DISK 

Syntax:ZAP[ , drive list][ , match list] 

For example, ZAP,1,.BAK would delete all files on drive #1 with 
a .BAK extension. 
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REX MEMORY MAP 



0400 


- OFFF 


HARD DISK DRIVER 


1000 


- 1640 


USER FCB'S 


1640 


- 20FF 


REX STACK 


2100 


- 2240 


SYSTEM FCB 


2280 


- 22FF 


LINE BUFFER 


2400 


- 4FFF 


REXDOS 


5000 


- 5FFF 


UTILITY COMMAND SPACE 


6000 


- 6FFFF 


APPLICATION RAM 


70000 


- 7BBFF 


SUBCAT OR OTHER SHELLS 


7BC00 


- 7FFFF 


TRACK BUFFERS 


80000 


- 100000 


SPOOLER RAM 



100000 - 3FFFFF USER RAM 



REX ERROR NUMBERS 



ERROR 


# 






Interpretation 


1 - 








ILLEGAL FUNCTION CODE 


2 - 








FILE IS IN USE 


3 - 








FILE EXISTS 


4 - 








FILE NOT FOUND 


5 - 








DIRECTORY IS FULL 


7 - 








ALL DISK SPACE HAS BEEN USED 


8 - 








READ PAST END OF FILE 


9 - 








DISK READ ERROR 


10 - 








DISK WRITE ERROR 


11 - 








DISK IS WRITE PROTECTED 


13 - 








ILLEGAL FILE CONTROL BLOCK 


14 - 








ILLEGAL DISK ADDRESS 


15 - 








ILLEGAL DRIVE NUMBER 


16 - 








DRIVE NOT READY 


18 - 








SYSTEM FILE STATUS ERROR 


21 - 








ILLEGAL FILE SPECIFICATION 


22 - 








SYSTEM FILE CLOSE ERROR 


26 - 








COMMAND SYNTAX ERROR 


29 - 








SEEK ERROR 
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